다음을 통해 공유

RpcMgmtInqServerPrincName 함수(rpcdce.h)

  • 아티클

RpcMgmtInqServerPrincName 함수는 서버의 보안 주체 이름을 반환합니다.

구문

RPC_STATUS RpcMgmtInqServerPrincName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

매개 변수

Binding

서버의 보안 주체 이름을 받으려면 해당 서버에 대한 서버 바인딩 핸들을 지정합니다. 사용자 고유의 (로컬) 애플리케이션에 대한 보안 주체 이름을 받으려면 NULL 값을 지정합니다.

AuthnSvc

보안 주체 이름이 반환되는 인증 서비스입니다. 유효한 값은 유효한 보안 공급자에 대한 상수입니다.

ServerPrincName

바인딩에서 참조된 서버에서 AuthnSvc의 인증 서비스에 대해 등록된 보안 주체 이름을 반환합니다. 여러 이름이 등록되면 하나의 이름만 반환됩니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_BINDING
 바인딩 핸들이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING
 이것은 작업에 대한 잘못된 종류의 바인딩이었습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

애플리케이션은 RpcMgmtInqServerPrincName 함수를 호출하여 지정된 인증 서비스에 등록된 서버의 보안 주체 이름을 가져옵니다.

RPC 런타임 라이브러리는 ServerPrincName에서 반환된 문자열에 대한 메모리를 할당합니다. 애플리케이션은 RpcStringFree 함수를 호출하여 이 함수에서 사용하는 메모리를 해제합니다.

이 함수가 성공하려면 서버에서 원격 프로시저 호출을 수신 대기해야 합니다. 서버가 수신 대기하지 않으면 함수가 실패합니다.

요구 사항

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

추가 정보

RpcStringFree