Skip to content

Commit

Permalink
Removing hardcoded en-us locale from links
Browse files Browse the repository at this point in the history
  • Loading branch information
drewbatgit committed Nov 27, 2019
1 parent 26540e6 commit 624cb0b
Show file tree
Hide file tree
Showing 7,498 changed files with 28,823 additions and 28,823 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This documentation assumes that the reader is familiar with COM operation and co
**To display a property sheet for an object in an Active Directory server**

1. Create a window that can be used to process messages. This can be an existing window or a special purpose window. This is known as the *hidden window*.
2. Create an OLE COM object that is derived from [**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx). This data object must support the following data formats:
2. Create an OLE COM object that is derived from [**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx). This data object must support the following data formats:

- [**CFSTR\_DSOBJECTNAMES**](cfstr-dsobjectnames.md) This data format contains a [**DSOBJECTNAMES**](/windows/desktop/api/Dsclient/ns-dsclient-dsobjectnames) that identifies the object that the property sheet applies to. When hosting a property sheet, the more significant members of the **DSOBJECTNAMES** structure are shown in the following list.

Expand Down Expand Up @@ -83,7 +83,7 @@ In some cases, the existing property sheets will need to display a secondary pro
**To duplicate the behavior of the CLSID\_DsPropertyPages object**

1. Enumerate the values in the [**adminPropertyPages**](https://docs.microsoft.com/windows/desktop/ADSchema/a-adminpropertypages) or [**shellPropertyPages**](https://docs.microsoft.com/windows/desktop/ADSchema/a-shellpropertypages) attribute for the display specifier for the object class. Each value is a string that contains a number, followed by a comma, followed by the string representation of the class identifier of the property page extension. For more information about the format of the property pages display specifier values, see [Registering the Property Page COM Object in a Display Specifier](registering-the-property-page-com-object-in-a-display-specifier.md).
2. Convert each class identifier string into a **CLSID** using the [**CLSIDFromString**](https://msdn.microsoft.com/en-us/library/ms683917(v=VS.85).aspx) function.
2. Convert each class identifier string into a **CLSID** using the [**CLSIDFromString**](https://msdn.microsoft.com/library/ms683917(v=VS.85).aspx) function.
3. Sort the extension class identifiers by the number that precedes each class identifier string in the attribute value. If two numbers are identical, sort the class identifiers in the order that the attribute values are obtained from the Active Directory server.
4. Enumerate the extension class identifiers, creating an instance of each extension.
5. For each extension, in the order sorted above, call the extension's [**IShellExtInit::Initialize**](https://msdn.microsoft.com/library/Bb775094(v=VS.85).aspx) with the same information described in Step 4 of the Hosting an Active Directory Users and Computers Property Sheet procedure.
Expand Down
4 changes: 2 additions & 2 deletions desktop-src/AD/administrative-notification-handlers.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ HKEY_CLASSES_ROOT - CLSID - <CLSID>



**<CLSID>** is the string representation of the CLSID as produced by the [**StringFromCLSID**](https://msdn.microsoft.com/en-us/library/ms683917(v=VS.85).aspx) function. Under the **<CLSID>** key, there is an **InProcServer32** key that identifies the object as a 32-bit in-proc server. Under the **InProcServer32** key, the location of the DLL is specified in the default value and the threading model is specified in the **ThreadingModel** value. All notification handlers must use the **Apartment** threading model.
**<CLSID>** is the string representation of the CLSID as produced by the [**StringFromCLSID**](https://msdn.microsoft.com/library/ms683917(v=VS.85).aspx) function. Under the **<CLSID>** key, there is an **InProcServer32** key that identifies the object as a 32-bit in-proc server. Under the **InProcServer32** key, the location of the DLL is specified in the default value and the threading model is specified in the **ThreadingModel** value. All notification handlers must use the **Apartment** threading model.

## Registering a Notification Handler with an Active Directory Server

Expand All @@ -57,7 +57,7 @@ Notification handlers are registered under the **dsUIAdminNotification** attribu

The "&lt;order number&gt;" is an unsigned number that represents the position of the handler in the confirmation dialog. When the confirmation dialog is displayed, the values are sorted using a comparison of each value's "&lt;order number&gt;". If more than one value has the same "&lt;order number&gt;", those handlers are displayed in the order they are read from the Active Directory server. A non-existing, that is, one not used by other values in the property, "&lt;order number&gt;" should be used if possible. There is no prescribed starting position, and gaps can appear in the "&lt;order number&gt;" sequence.

The "&lt;CLSID&gt;" is the string representation of the CLSID as produced by the [**StringFromCLSID**](https://msdn.microsoft.com/en-us/library/ms683917(v=VS.85).aspx) function.
The "&lt;CLSID&gt;" is the string representation of the CLSID as produced by the [**StringFromCLSID**](https://msdn.microsoft.com/library/ms683917(v=VS.85).aspx) function.



Expand Down
2 changes: 1 addition & 1 deletion desktop-src/AD/binding-to-the-global-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ GC://servername.fabrikam.com/DC=sales,DC=fabrikam,DC=com

1. Bind to the root of the Global Catalog namespace.
2. Enumerate the Global Catalog container. The Global Catalog container contains a single object that you can use to search the entire forest.
3. Use the object in the container to perform the search. In C/C++, call [**QueryInterface**](https://msdn.microsoft.com/en-us/library/ms682521(v=VS.85).aspx) to get an [**IDirectorySearch**](https://docs.microsoft.com/windows/desktop/api/iads/nn-iads-idirectorysearch) pointer on the object so that you can use the **IDirectorySearch** interface to perform the search. In Visual Basic, use the object returned from the enumeration in your ADO query.
3. Use the object in the container to perform the search. In C/C++, call [**QueryInterface**](https://msdn.microsoft.com/library/ms682521(v=VS.85).aspx) to get an [**IDirectorySearch**](https://docs.microsoft.com/windows/desktop/api/iads/nn-iads-idirectorysearch) pointer on the object so that you can use the **IDirectorySearch** interface to perform the search. In Visual Basic, use the object returned from the enumeration in your ADO query.

To enumerate the Global Catalog servers in a site, perform an LDAP subtree search of "cn=<yoursite>,cn=sites,<DN of the configurationNamingContext>", using the following filter string.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ LDAP://<servername>/<WKGUID=<XXXXX>,<container DN>>

"&lt;server name&gt;" is the directory server name. The "&lt;server name&gt;" is optional.

"&lt;XXXXX&gt;" is the string representation of the hexadecimal value of the GUID that represents the well-known object. The GUID string is specified in the "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" form and is not the same form as the GUID string produced by the [**StringFromGUID2**](https://msdn.microsoft.com/en-us/library/ms683893(v=VS.85).aspx) function, which takes the form "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}". For more information and a code example that shows how to create a bindable string from a GUID, see [Example Code for Creating a Bindable String Representation of a GUID](example-code-for-creating-a-bindable-string-representation-of-a-guid.md).
"&lt;XXXXX&gt;" is the string representation of the hexadecimal value of the GUID that represents the well-known object. The GUID string is specified in the "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" form and is not the same form as the GUID string produced by the [**StringFromGUID2**](https://msdn.microsoft.com/library/ms683893(v=VS.85).aspx) function, which takes the form "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}". For more information and a code example that shows how to create a bindable string from a GUID, see [Example Code for Creating a Bindable String Representation of a GUID](example-code-for-creating-a-bindable-string-representation-of-a-guid.md).

To bind to an object specified in **otherWellKnownObjects** in an object, specify "&lt;XXXXX&gt;" as the bind string form of the well-known object GUID of the object. For more information, see [Reading an Object's objectGUID and Creating a String Representation of the GUID](reading-an-objectampaposs-objectguid-and-creating-a-string-representation-of-the-guid.md). For more information about setting the **otherWellKnownObjects** property on objects, see [Enabling Rename-Safe Binding with the otherWellKnownObjects Property](enabling-rename-safe-binding-with-the-otherwellknownobjects-property.md).

Expand Down
6 changes: 3 additions & 3 deletions desktop-src/AD/cfstr-dsobjectnames.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ms.date: 05/31/2018



The **CFSTR\_DSOBJECTNAMES** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSOBJECTNAMES** clipboard format provides a global memory handle (**HGLOBAL**) that contains [**DSOBJECTNAMES**](/windows/desktop/api/Dsclient/ns-dsclient-dsobjectnames) structure.
The **CFSTR\_DSOBJECTNAMES** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSOBJECTNAMES** clipboard format provides a global memory handle (**HGLOBAL**) that contains [**DSOBJECTNAMES**](/windows/desktop/api/Dsclient/ns-dsclient-dsobjectnames) structure.


</dt> </dl> </dd> </dl>
Expand All @@ -48,10 +48,10 @@ The **CFSTR\_DSOBJECTNAMES** clipboard format is supported by the [**IDataObject

<dl> <dt>

[**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx)
[**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx)
</dt> <dt>

[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx)
[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx)
</dt> <dt>

[**DSOBJECTNAMES**](/windows/desktop/api/Dsclient/ns-dsclient-dsobjectnames)
Expand Down
2 changes: 1 addition & 1 deletion desktop-src/AD/cfstr-dsop-ds-selection-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ms.date: 05/31/2018



The **CFSTR\_DSOP\_DS\_SELECTION\_LIST** clipboard format is provided by the [**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx) obtained by calling [**IDsObjectPicker::InvokeDialog**](/windows/desktop/api/Objsel/nf-objsel-idsobjectpicker-invokedialog). The **CFSTR\_DSOP\_DS\_SELECTION\_LIST** clipboard format provides an **HGLOBAL** that contains a [**DS\_SELECTION\_LIST**](/windows/desktop/api/Objsel/ns-objsel-ds_selection_list) structure. The **DS\_SELECTION\_LIST** structure contains data about the items selected in a [Directory Object Picker](directory-object-picker.md) dialog box.
The **CFSTR\_DSOP\_DS\_SELECTION\_LIST** clipboard format is provided by the [**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx) obtained by calling [**IDsObjectPicker::InvokeDialog**](/windows/desktop/api/Objsel/nf-objsel-idsobjectpicker-invokedialog). The **CFSTR\_DSOP\_DS\_SELECTION\_LIST** clipboard format provides an **HGLOBAL** that contains a [**DS\_SELECTION\_LIST**](/windows/desktop/api/Objsel/ns-objsel-ds_selection_list) structure. The **DS\_SELECTION\_LIST** structure contains data about the items selected in a [Directory Object Picker](directory-object-picker.md) dialog box.


</dt> </dl> </dd> </dl>
Expand Down
6 changes: 3 additions & 3 deletions desktop-src/AD/cfstr-dsqueryparams.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ms.date: 05/31/2018



The **CFSTR\_DSQUERYPARAMS** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSQUERYPARAMS** clipboard format provides a global memory handle (**HGLOBAL**) that contains a [**DSQUERYPARAMS**](/windows/desktop/api/Dsquery/ns-dsquery-dsqueryparams) structure.
The **CFSTR\_DSQUERYPARAMS** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSQUERYPARAMS** clipboard format provides a global memory handle (**HGLOBAL**) that contains a [**DSQUERYPARAMS**](/windows/desktop/api/Dsquery/ns-dsquery-dsqueryparams) structure.


</dt> </dl> </dd> </dl>
Expand All @@ -48,10 +48,10 @@ The **CFSTR\_DSQUERYPARAMS** clipboard format is supported by the [**IDataObject

<dl> <dt>

[**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx)
[**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx)
</dt> <dt>

[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx)
[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx)
</dt> <dt>

[**DSQUERYPARAMS**](/windows/desktop/api/Dsquery/ns-dsquery-dsqueryparams)
Expand Down
6 changes: 3 additions & 3 deletions desktop-src/AD/cfstr-dsqueryscope.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ms.date: 05/31/2018



The **CFSTR\_DSQUERYSCOPE** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSQUERYSCOPE** clipboard format provides a global memory handle (**HGLOBAL**) that contains a string that specifies the query scope.
The **CFSTR\_DSQUERYSCOPE** clipboard format is supported by the [**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx) provided by the [**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx) method. The **CFSTR\_DSQUERYSCOPE** clipboard format provides a global memory handle (**HGLOBAL**) that contains a string that specifies the query scope.


</dt> </dl> </dd> </dl>
Expand All @@ -48,10 +48,10 @@ The **CFSTR\_DSQUERYSCOPE** clipboard format is supported by the [**IDataObject*

<dl> <dt>

[**IDataObject**](https://msdn.microsoft.com/en-us/library/ms688421(v=VS.85).aspx)
[**IDataObject**](https://msdn.microsoft.com/library/ms688421(v=VS.85).aspx)
</dt> <dt>

[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/en-us/library/ms676933(v=VS.85).aspx)
[**ICommonQuery::OpenQueryWindow**](https://msdn.microsoft.com/library/ms676933(v=VS.85).aspx)
</dt> </dl>


Expand Down
8 changes: 4 additions & 4 deletions desktop-src/AD/container-browser.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,20 +20,20 @@ The **pszRoot** member is a pointer to a Unicode string that contains the root c

The **pszPath** member receives the ADsPath of the selected object. It is possible to specify a particular container to be visible and selected when the dialog box is first displayed. This is accomplished by setting **pszPath** to the ADsPath of the item to be selected and setting the **DSBI\_EXPANDONOPEN** flag in **dwFlags**.

The contents and behavior of the dialog box can also be controlled at runtime by implementing a [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx) function. The **BFFCallBack** function is implemented by the application and is called when certain events occur. An application can use these events to control how the items in the dialog box are displayed as well as the actual contents of the dialog box. For example, an application can filter the items displayed in the dialog box by implementing a **BFFCallBack** function that can handle the **DSBM\_QUERYINSERT** notification. When a **DSBM\_QUERYINSERT** notification is received, use the **pszADsPath** member of the [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema) structure to determine which item is about to be inserted. If the application determines that the item should not be displayed, it can hide the item by performing the following steps.
The contents and behavior of the dialog box can also be controlled at runtime by implementing a [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx) function. The **BFFCallBack** function is implemented by the application and is called when certain events occur. An application can use these events to control how the items in the dialog box are displayed as well as the actual contents of the dialog box. For example, an application can filter the items displayed in the dialog box by implementing a **BFFCallBack** function that can handle the **DSBM\_QUERYINSERT** notification. When a **DSBM\_QUERYINSERT** notification is received, use the **pszADsPath** member of the [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema) structure to determine which item is about to be inserted. If the application determines that the item should not be displayed, it can hide the item by performing the following steps.

1. Add the **DSBF\_STATE** flag to the **dwMask** member of the [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema) structure.
2. Add the **DSBS\_HIDDEN** flag to the **dwStateMask** member of the [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema) structure.
3. Add the **DSBS\_HIDDEN** flag to the **dwState** member of the [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema) structure.
4. Return a nonzero value from the [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx) function.
4. Return a nonzero value from the [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx) function.

In addition to hiding certain items, an application can modify the text and icon displayed for the item by handling the **DSBM\_QUERYINSERT** notification. For more information, see [**DSBITEM**](/windows/desktop/api/Dsclient/ns-dsclient-dsbitema).

The [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx) function can use the **BFFM\_INITIALIZED** notification to obtain the handle of the dialog box. The application can use this handle to send messages, such as **BFFM\_ENABLEOK**, to the dialog box. For more information about the messages that can be sent to the dialog box, see [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx).
The [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx) function can use the **BFFM\_INITIALIZED** notification to obtain the handle of the dialog box. The application can use this handle to send messages, such as **BFFM\_ENABLEOK**, to the dialog box. For more information about the messages that can be sent to the dialog box, see [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx).

The dialog box handle can also be used to gain direct access to the controls in the dialog box. **DSBID\_BANNER** is the identifier for the static text control that the **pszTitle** member of the [**DSBROWSEINFO**](/windows/desktop/api/Dsclient/ns-dsclient-dsbrowseinfoa) structure is displayed in. **DSBID\_CONTAINERLIST** is the identifier of the tree view control used to display the tree contents. Use of these items should be avoided, if possible, to prevent future application compatibility problems.

The following C++ code example shows how to use the [**DsBrowseForContainer**](/windows/desktop/api/Dsclient/nf-dsclient-dsbrowseforcontainera) function to create the container browser dialog box and implement a [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx) function. The [**BFFCallBack**](https://msdn.microsoft.com/en-us/library/ms675173(v=VS.85).aspx) uses the **DSBM\_QUERYINSERT** notification to change the display name for each item to the distinguished name of the item.
The following C++ code example shows how to use the [**DsBrowseForContainer**](/windows/desktop/api/Dsclient/nf-dsclient-dsbrowseforcontainera) function to create the container browser dialog box and implement a [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx) function. The [**BFFCallBack**](https://msdn.microsoft.com/library/ms675173(v=VS.85).aspx) uses the **DSBM\_QUERYINSERT** notification to change the display name for each item to the distinguished name of the item.


```C++
Expand Down
Loading

0 comments on commit 624cb0b

Please sign in to comment.