RpcServerInqDefaultPrincName 함수(rpcdce.h)
RpcServerInqDefaultPrincName 함수는 지정된 인증 서비스의 기본 보안 주체 이름을 가져옵니다.
구문
RPC_STATUS RpcServerInqDefaultPrincName(
unsigned long AuthnSvc,
RPC_WSTR *PrincName
);
매개 변수
AuthnSvc
서버가 원격 프로시저 호출에 대한 요청을 수신할 때 사용할 인증 서비스입니다.
PrincName
성공하면 AuthnSvc 매개 변수에 지정된 지정된 인증 서비스의 기본 보안 주체 이름을 포함합니다. 사용 중인 인증 서비스는 이름 및 해당 구문의 콘텐츠를 정의합니다. 이 보안 주체 이름은 RpcServerRegisterAuthInfo 함수의 ServerPrincName 매개 변수로 사용해야 합니다. 함수가 성공하면 RpcStringFree 함수를 사용하여 PrincName을 해제해야 합니다. 함수가 실패하면 PrincName 의 내용이 정의되지 않으며 호출자는 함수를 해제할 의무가 없습니다.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
메모리가 부족하여 작업을 완료할 수 없습니다. |
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
설명
이 함수는 RpcServerRegisterAuthInfo 함수에 전달할 서버 보안 주체 이름을 가져오는 데 권장되는 방법입니다. 이 함수를 사용하지 않고 서버 보안 주체 이름을 작성할 수 있지만, 운영 체제 버전에서 함수를 호출하는 것이 더 쉽고 이식 가능합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |