RpcNsProfileEltInqNextA 함수(rpcnsi.h)
RpcNsProfileEltInqNext 함수는 프로필에서 한 번에 하나의 요소를 반환합니다.
구문
RPC_STATUS RpcNsProfileEltInqNextA(
RPC_NS_HANDLE InquiryContext,
RPC_IF_ID *IfId,
RPC_CSTR *MemberName,
unsigned long *Priority,
RPC_CSTR *Annotation
);
매개 변수
InquiryContext
RpcNsProfileEltInqBegin 함수에서 반환된 이름 서비스 핸들입니다.
IfId
프로필 요소의 인터페이스 식별에 대한 포인터를 반환합니다.
MemberName
프로필 요소의 멤버 이름에 대한 포인터에 대한 포인터를 반환합니다. 반환된 이름의 구문은 RpcNsProfileEltInqBegin 함수의 MemberNameSyntax 매개 변수에 의해 지정되었습니다.
RpcNsProfileEltInqNext가MemberName 매개 변수를 반환하지 못하도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출하지 않습니다.
Priority
profile-element 우선 순위에 대한 포인터를 반환합니다.
Annotation
프로필 요소의 주석 문자열에 대한 포인터에 대한 포인터를 반환합니다. profile 요소에 주석 문자열이 없으면 \0 문자열이 반환됩니다.
RpcNsProfileEltInqNext가 Annotation 매개 변수를 반환하지 못하도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출할 필요가 없습니다.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
이름이 불완전합니다. |
|
이름 서비스를 사용할 수 없습니다. |
|
더 이상 요소가 없습니다. |
설명
RpcNsProfileEltInqNext 함수는 RpcNsProfileEltInqBegin의 ProfileName 매개 변수로 지정된 프로필에서 하나의 요소를 반환합니다. RpcNsProfileEltInqBegin의 InquiryType 값에 관계없이 RpcNsProfileEltInqNext는 프로필 요소의 모든 구성 요소(인터페이스 식별, 멤버 이름, 우선 순위, 주석 문자열)를 반환합니다.
애플리케이션은 RpcNsProfileEltInqNext 함수를 반복적으로 호출하여 선택한 모든 프로필 항목을 볼 수 있습니다. 모든 요소를 볼 때 이 함수는 RPC_S_NO_MORE_ELEMENTS 상태 코드를 반환합니다. 반환된 요소는 순서가 지정되지 않습니다.
프로필 요소를 반환하는 RpcNsProfileEltInqNext 에 대한 각 호출에서 RPC 런타임 라이브러리는 반환된 멤버 이름 및 주석 문자열에 대한 메모리를 할당합니다. 애플리케이션은 반환된 각 멤버 이름 및 주석 문자열에 대해 RpcStringFree 함수를 호출합니다. 프로필의 요소를 본 후 애플리케이션은 RpcNsProfileEltInqDone 을 호출하여 조회 컨텍스트를 해제해야 합니다.
참고
rpcnsi.h 헤더는 RpcNsProfileEltInqNext를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcnsi.h(Rpc.h 포함) |
| 라이브러리 | Rpcns4.lib |
| DLL | Rpcns4.dll |