IConnectedIdentityProvider::ConnectIdentity 메서드(identityprovider.h)

도메인 사용자에게 ID를 연결합니다.

구문

HRESULT ConnectIdentity(
  [in] BYTE  *AuthBuffer,
  [in] ULONG AuthBufferSize
);

매개 변수

[in] AuthBuffer

온라인 ID의 자격 증명을 포함하는 마샬링 된 인증 버퍼 SEC_WINNT_AUTH_IDENTITY_EX2 구조체입니다. CRED_PACK_ID_PROVIDER_CREDENTIALS 옵션과 함께 CredPackAuthenticationBuffer 함수를 사용하거나 CredUIPromptForWindowsCredentials 함수에서 온라인 ID 자격 증명 공급자가 반환하여 호출자가 버퍼를 생성할 수 있습니다. 버퍼는 필요에 따라 SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON 옵션을 사용하여 SspiEncryptAuthIdentityEx 함수를 호출하여 암호화할 수 있습니다.

[in] AuthBufferSize

AuthBuffer 매개 변수의 크기(바이트)입니다.

반환 값

메서드가 성공하면 S_OK 반환합니다.

메서드가 실패하면 Win32 오류 코드를 반환합니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
ERROR_LOGON_FAILURE	사용자 이름 또는 암호가 올바르지 않습니다.
ERROR_USER_EXISTS	도메인 사용자가 이미 연결되어 있거나 이 공급자의 온라인 ID와 연결되어 있습니다.
ERROR_INVALID_ACCOUNT_NAME	온라인 사용자 이름의 형식이 잘못되었습니다.

설명

보안 데스크톱에서 자격 증명을 수집하는 경우 시스템 컨텍스트에서 AuthBuffer 매개 변수를 암호화할 수 있습니다. 이 경우 ID 공급자는 현재 프로세스에서 자격 증명의 암호를 해독할 수 없습니다. 버퍼의 암호를 해독하려면 ID 공급자가 시스템 컨텍스트에서 실행 중인 프로세스에 자격 증명을 보내야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	identityprovider.h

참고 항목

IConnectedIdentityProvider