microsoft / microsoft/Windows-classic-samples

RecipeThumbnailProvider: explain CRecipeThumbProvider_CreateInstance

Open
#262 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
5.7k
Forks
3.3k
PR merge metrics
No merged PRs in 30d

Description

The code sample for CRecipeThumbProvider defines a function HRESULT CRecipeThumbProvider_CreateInstance(REFIID riid, void **ppv) without explaining its purpose or otherwise making easy to understand why it exists. I thought that maybe function names ending in _CreateInstance had some special meaning to the Windows shell, but was not able to find any such information.

The code sample should have a comment justifying the existence of the function.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open Samples/Win7Samples/winui/shell/appshellintegration/RecipeThumbnailProvider/RecipeThumbnailProvider.cpp around line 81 and read CRecipeThumbProvider_CreateInstance in context. Add a comment explaining why the function exists and whether its name has any special Windows Shell meaning. Done means the code sample makes that purpose clear without requiring outside research.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.