COSERVERINFO 구조체(objidl.h)

아티클
08/25/2023

활성화 함수에 대한 원격 컴퓨터 리소스를 식별합니다.

구문

typedef struct _COSERVERINFO {
  DWORD      dwReserved1;
  LPWSTR     pwszName;
  COAUTHINFO *pAuthInfo;
  DWORD      dwReserved2;
} COSERVERINFO;

멤버

dwReserved1

이 멤버는 예약되어 있으며 0이어야 합니다.

pwszName

컴퓨터의 이름.

pAuthInfo

컴퓨터 원격 활성화에 대한 기본 활성화 보안을 재정의하는 COAUTHINFO 구조체에 대한 포인터입니다. 그렇지 않으면 기본값을 사용해야 함을 나타내려면 NULL 로 설정합니다. 자세한 내용은 주의 섹션을 참조하세요.

dwReserved2

이 멤버는 예약되어 있으며 0이어야 합니다.

설명

COSERVERINFO 구조체는 주로 개체 생성 함수에서 원격 시스템을 식별하는 데 사용됩니다. 컴퓨터 리소스의 이름은 네트워크 전송의 명명 체계를 사용하여 지정됩니다. 기본적으로 모든 UNC("\\server" 또는 "server") 및 DNS 이름("domain.com", "example.microsoft.com" 또는 "135.5.33.19") 이름이 허용됩니다.

pAuthInfo가 NULL로 설정된 경우 Snego는 클라이언트와 서버 간에 작동하는 인증 서비스를 협상하는 데 사용됩니다. 그러나 pAuthInfo에 대해 NULL이 아닌 COAUTHINFO 구조를 지정하여 다음 요구 사항 중 하나를 충족할 수 있습니다.

컴퓨터 원격 활성화에 대해 다른 클라이언트 ID를 지정하려면 지정된 ID는 실제 클라이언트 ID가 아닌 서버의 시작 권한 검사 사용됩니다.
NTLMSSP가 아닌 Kerberos가 컴퓨터 원격 활성화에 사용되도록 지정합니다. 기본이 아닌 클라이언트 ID를 지정하거나 지정하지 않을 수 있습니다.
안전하지 않은 활성화를 요청합니다.
독점 인증 서비스를 지정하려면

pAuthInfo가 NULL이 아닌 경우 해당 값은 원격 호출에 대한 인증 설정을 지정하는 데 사용됩니다. 이러한 설정은 RpcBindingSetAuthInfoEx 함수에 전달됩니다.

pAuthInfo 매개 변수가 NULL이면 CoInitializeSecurity 함수에서 설정한 인증 수준으로 dwAuthnLevel을 재정의할 수 있습니다. CoInitializeSecurity 함수가 호출되지 않으면 AppID 레지스트리 키 아래에 지정된 인증 수준이 사용됩니다(있는 경우).

WINDOWS XP SP2(서비스 팩 2)부터 dwAuthnLevel 은 정품 인증 요청을 실행하는 클라이언트 프로세스의 최대 RPC_C_AUTHN_LEVEL_CONNECT 및 프로세스 전체 인증 수준입니다. 이전 버전의 운영 체제에서는 RPC_C_AUTHN_LEVEL_CONNECT.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
머리글	objidl.h(Objidl.h 포함)