RpcNsEntryObjectInqBeginA 함수(rpcnsi.h)

RpcNsEntryObjectInqBegin 함수는 이름 서비스 데이터베이스 항목의 개체에 대한 조회 컨텍스트를 만듭니다.

참고 이 함수는 Windows Vista 이상 운영 체제에서 지원되지 않습니다.

 

구문

RPC_STATUS RpcNsEntryObjectInqBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_NS_HANDLE *InquiryContext
);

매개 변수

EntryNameSyntax

EntryName에서 사용할 구문입니다.

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax레지스트리 값 항목에 지정된 구문을 사용하려면 RPC_C_NS_SYNTAX_DEFAULT 값을 제공합니다.

EntryName

개체 UUID를 볼 이름 서비스 데이터베이스 항목 이름에 대한 포인터입니다.

InquiryContext

RpcNsEntryObjectInqNext 및 RpcNsEntryObjectInqDone 함수와 함께 사용할 이름 서비스 핸들에 대한 포인터를 반환합니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_NAME_SYNTAX	이름 구문이 잘못되었습니다.
RPC_S_UNSUPPORTED_NAME_SYNTAX	이름 구문은 지원되지 않습니다.
RPC_S_INCOMPLETE_NAME	이름이 불완전합니다.
RPC_S_ENTRY_NOT_FOUND	이름 서비스 항목을 찾을 수 없습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE	이름 서비스를 사용할 수 없습니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

설명

RpcNsEntryObjectInqBegin 함수는 EntryName으로 내보낸 개체 UUID를 보기 위한 조회 컨텍스트를 만듭니다.

RpcNsEntryObjectInqNext 함수를 호출하기 전에 애플리케이션은 먼저 RpcNsEntryObjectInqBegin을 호출하여 조회 컨텍스트를 만들어야 합니다.

개체 UUID 보기가 완료되면 애플리케이션은 RpcNsEntryObjectInqDone 함수를 호출하여 조회 컨텍스트를 삭제합니다.

참고

rpcnsi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 RpcNsEntryObjectInqBegin을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rpcnsi.h(Rpc.h 포함)
라이브러리	Rpcns4.lib
DLL	Rpcns4.dll

추가 정보

RpcNsBindingExport

RpcNsEntryObjectInqDone

RpcNsEntryObjectInqNext