Export (0) Print
Expand All
Expand Minimize

RpcNsProfileEltInqNext function

The RpcNsProfileEltInqNext function returns one element at a time from a profile.

Note  This function is not supported on Windows Vista and later operating systems.

Syntax


RPC_STATUS RPC_ENTRY RpcNsProfileEltInqNext(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID *IfId,
  unsigned char **MemberName,
  unsigned long *Priority,
  unsigned char **Annotation
);

Parameters

InquiryContext

Name-service handle returned from the RpcNsProfileEltInqBegin function.

IfId

Returns a pointer to the interface identification of the profile element.

MemberName

Returns a pointer to a pointer to the profile element's member name.The syntax of the returned name was specified by the MemberNameSyntax parameter in the RpcNsProfileEltInqBegin function.

Specify a null value to prevent RpcNsProfileEltInqNext from returning the MemberName parameter. In this case, the application does not call the RpcStringFree function.

Priority

Returns a pointer to the profile-element priority.

Annotation

Returns a pointer to a pointer to the annotation string for the profile element. If there is no annotation string in the profile element, the string \0 is returned.

Specify a null value to prevent RpcNsProfileEltInqNext from returning the Annotation parameter. In this case, the application does not need to call the RpcStringFree function.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_INCOMPLETE_NAME

The name is incomplete.

RPC_S_NAME_SERVICE_UNAVAILABLE

The name service is unavailable.

RPC_S_NO_MORE_ELEMENTS

No more elements.

 

Note  For a list of valid error codes, see RPC Return Values.

Remarks

The RpcNsProfileEltInqNext function returns one element from the profile specified by the ProfileName parameter in RpcNsProfileEltInqBegin. Regardless of the value of InquiryType in RpcNsProfileEltInqBegin, RpcNsProfileEltInqNext returns all the components (interface identification, member name, priority, annotation string) of a profile element.

An application can view all the selected profile entries by repeatedly calling the RpcNsProfileEltInqNext function. When all the elements have been viewed, this function returns a RPC_S_NO_MORE_ELEMENTS status code. The returned elements are unordered.

On each call to RpcNsProfileEltInqNext that returns a profile element, the RPC run-time library allocates memory for the returned member name and annotation string. The application is responsible for calling the RpcStringFree function for each returned member name and annotation string. After viewing the profile's elements, the application must call RpcNsProfileEltInqDone to release the inquiry context.

Note  Windows 2000 Active Directory supports this function. Earlier versions of Windows NT support the use of this function with Cell Directory Service (CDS) only.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcnsi.h (include Rpc.h)

Library

Rpcns4.lib

DLL

Rpcns4.dll

Unicode and ANSI names

RpcNsProfileEltInqNextW (Unicode) and RpcNsProfileEltInqNextA (ANSI)

See also

RpcNsProfileEltInqBegin
RpcNsProfileEltInqDone
RpcStringFree

 

 

Community Additions

ADD
Show:
© 2014 Microsoft