다음을 통해 공유

RpcServerInqDefaultPrincNameW 함수(rpcdce.h)

  • 아티클

RpcServerInqDefaultPrincName 함수는 지정된 인증 서비스의 기본 보안 주체 이름을 가져옵니다.

통사론

RPC_STATUS RpcServerInqDefaultPrincNameW(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

매개 변수

AuthnSvc

서버가 원격 프로시저 호출에 대한 요청을 수신할 때 사용할 인증 서비스입니다.

PrincName

성공하면 AuthnSvc 매개 변수에 지정된 지정된 인증 서비스의 기본 보안 주체 이름을 포함합니다. 사용 중인 인증 서비스는 이름 및 해당 구문의 내용을 정의합니다. 이 보안 주체 이름은 RpcServerRegisterAuthInfo 함수의 ServerPrincName 매개 변수로 사용해야 합니다. 함수가 성공하면 RpcStringFree 함수를 사용하여 PrincName 해제해야 합니다. 함수가 실패하면 PrincName 내용이 정의되지 않으며 호출자는 이 함수를 해제할 의무가 없습니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_OUT_OF_MEMORY
 작업을 완료할 메모리가 부족합니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값참조하세요.
 

발언

이 함수는 RpcServerRegisterAuthInfo 함수에 전달할 서버 보안 주체 이름을 가져오는 데 권장되는 방법입니다. 이 함수를 사용하지 않고 서버 보안 주체 이름을 작성할 수 있지만, 운영 체제 버전에서 함수를 호출하는 것이 더 쉽고 이식 가능합니다.

메모

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

요구 사항

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

참고 항목

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo