다음을 통해 공유

RpcMgmtInqServerPrincNameA 함수(rpcdce.h)

  • 아티클

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

통사론

RPC_STATUS RpcMgmtInqServerPrincNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_CSTR           *ServerPrincName
);

매개 변수

Binding

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

AuthnSvc

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

ServerPrincName

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

반환 값

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

발언

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

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

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

메모

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

요구 사항

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

참고 항목

RpcStringFree