Skip to content

wuapi: IUpdate: setter and getter param and retval info, slight corrections#2194

Open
RavuAlHemio wants to merge 6 commits into
MicrosoftDocs:docsfrom
RavuAlHemio:wuapi-iupdate-params-retval
Open

wuapi: IUpdate: setter and getter param and retval info, slight corrections#2194
RavuAlHemio wants to merge 6 commits into
MicrosoftDocs:docsfrom
RavuAlHemio:wuapi-iupdate-params-retval

Conversation

@RavuAlHemio
Copy link
Copy Markdown
Contributor

I hope that the commit messages shed some light on my reasoning.

My primary concern was linking from a getter such as IUpdate::get_DownloadPriority to its enum type (DownloadPriority in this case), since I sorely missed these when navigating the Windows Update API docs, but I made a few more changes.

Link to the relevant data type if an article exists; for data types mostly
used in conjunction with VARIANT, link to VARIANT under "see also" instead.
Also link to SysFreeString for BSTR values.

The most direct benefit is the link to enum types like DeploymentAction or
DownloadPriority.
Since AcceptEula is an action that can only be taken in one direction, it
makes sense for it to be its own method instead of an EulaAccepted setter,
but the two should still be cross-linked.
@prmerger-automator
Copy link
Copy Markdown

@RavuAlHemio : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants