RpcNsMgmtEntryInqIfIdsA 함수(rpcnsi.h)

RpcNsMgmtEntryInqIfIds 함수는 이름 서비스-데이터베이스 항목으로 내보낸 인터페이스 목록을 반환합니다. 또한 서버에서 EntryName으로 내보낸 바인딩 핸들의 인터페이스를 포함하는 인터페이스 식별 벡터를 반환합니다. 이 함수는 만료 기간인 0을 사용하여 이름 서비스 데이터의 로컬 복사본을 즉시 업데이트합니다.

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

 

구문

RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
  unsigned long    EntryNameSyntax,
  RPC_CSTR         EntryName,
  RPC_IF_ID_VECTOR **IfIdVec
);

매개 변수

EntryNameSyntax

EntryName 구문입니다.

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

EntryName

인터페이스 식별 벡터가 반환되는 이름 서비스-데이터베이스 항목 이름에 대한 포인터입니다.

IfIdVec

인터페이스 식별 벡터에 대한 포인터의 주소를 반환합니다.

반환 값

값	의미
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 반환 값을 참조하세요.

 

설명

RpcNsMgmtEntryInqIfIds 함수는 서버에서 EntryName으로 내보낸 바인딩 핸들의 인터페이스를 포함하는 인터페이스 식별 벡터를 반환합니다. 이 함수는 만료 기간인 0을 사용하여 이름 서비스 데이터의 로컬 복사본을 즉시 업데이트합니다. 호출 애플리케이션은 RpcIfIdVectorFree 함수를 호출하여 벡터에서 사용하는 메모리를 해제합니다.

참고

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

요구 사항

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

추가 정보

RpcIfIdVectorFree

RpcIfInqId

RpcNsBindingExport