RpcNsProfileEltInqBegin function
The RpcNsProfileEltInqBegin function creates an inquiry context for viewing the elements in a profile.
Syntax
RPC_STATUS RPC_ENTRY RpcNsProfileEltInqBegin( unsigned long ProfileNameSyntax, unsigned char *ProfileName, unsigned long InquiryType, RPC_IF_ID *IfId, unsigned long VersOption, unsigned long MemberNameSyntax, unsigned char *MemberName, RPC_NS_HANDLE *InquiryContext );
Parameters
- ProfileNameSyntax
-
Syntax of ProfileName.
To use the syntax specified in the registry value entry HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
- ProfileName
-
Pointer to the name of the profile to view.
- InquiryType
-
Type of inquiry to perform on the profile. The following table lists valid inquiry types.
- IfId
-
Pointer to the interface identification of the profile elements to be returned by the RpcNsProfileEltInqNext function.
The IfId parameter is used only when specifying a value of RPC_C_PROFILE_MATCH_BY_IF or RPC_C_PROFILE_MATCH_BY_BOTH for the InquiryType parameter. Otherwise, IfId is ignored and a null value can be specified.
- VersOption
-
Specifies how the RpcNsProfileEltInqNext function uses the IfId parameter. This parameter is used only when specifying a value of RPC_C_PROFILE_MATCH_BY_IF or RPC_C_PROFILE_MATCH_BY_BOTH for InquiryType. Otherwise, this parameter is ignored and a 0 value can be specified.
The following table describes valid values for VersOption.
Value Meaning - RPC_C_VERS_ALL
Returns profile elements that offer the specified interface UUID, regardless of the version numbers. For this value, specify 0 for both the major and minor versions in IfId.
- RPC_C_VERS_COMPATIBLE
Returns profile elements that offer the same major version of the specified interface UUID and a minor version greater than or equal to the minor version of the specified interface UUID.
- RPC_C_VERS_EXACT
Returns profile elements that offer the specified version of the specified interface UUID.
- RPC_C_VERS_MAJOR_ONLY
Returns profile elements that offer the same major version of the specified interface UUID (ignores the minor version). For this value, specify 0 for the minor version in IfId.
- RPC_C_VERS_UPTO
Returns profile elements that offer a version of the specified interface UUID less than or equal to the specified major and minor version. (For example, if the IfId contained V2.0 and the profile contained elements with V1.3, V2.0, and V2.1, the RpcNsProfileEltInqNext function returns elements with V1.3 and V2.0.)
- MemberNameSyntax
-
Syntax of MemberName, and the return parameter MemberName in the RpcNsProfileEltInqNext function.
To use the syntax specified in the registry value entry HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
- MemberName
-
Pointer to the member name that the RpcNsProfileEltInqNext function looks for in profile elements. The MemberName parameter is used only when specifying a value of RPC_C_PROFILE_MATCH_BY_MBR or RPC_C_PROFILE_MATCH_BY_BOTH for InquiryType. Otherwise, MemberName is ignored and a null value can be specified.
- InquiryContext
-
Returns a pointer to a name-service handle for use with the RpcNsProfileEltInqNext and RpcNsProfileEltInqDone functions.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The version option is invalid. |
|
The name syntax is invalid. |
|
The name syntax is not supported. |
|
The name is incomplete. |
|
The name-service entry was not found. |
|
The name service is unavailable. |
Remarks
The RpcNsProfileEltInqBegin function creates an inquiry context for viewing the elements in a profile.
Using the InquiryType parameter, an application specifies which of the following profile elements are to be returned from calls to RpcNsProfileEltInqNext:
- The default element
- All elements
- Elements with the specified interface identification
- Elements with the specified member name
- Elements with both the specified interface identification and member name
Before calling RpcNsProfileEltInqNext, the application must first call RpcNsProfileEltInqBegin to create an inquiry context.
When finished viewing the profile elements, the application calls the RpcNsProfileEltInqDone function to delete the inquiry context.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
RpcNsProfileEltInqBeginW (Unicode) and RpcNsProfileEltInqBeginA (ANSI) |
See also