다음을 통해 공유

BG_BASIC_CREDENTIALS 구조체(bits1_5.h)

  • 아티클

인증할 사용자 이름 및 암호를 식별합니다.

구문

typedef struct __MIDL_IBackgroundCopyJob2_0001 {
  LPWSTR UserName;
  LPWSTR Password;
} BG_BASIC_CREDENTIALS;

멤버

UserName

인증할 사용자 이름을 포함하는 null로 끝나는 문자열입니다. 사용자 이름은 null 종결자를 포함하지 않고 300자로 제한됩니다. 사용자 이름의 형식은 요청된 인증 체계에 따라 달라집니다. 예를 들어 기본, NTLM 및 협상 인증의 경우 사용자 이름은 DomainName UserName\ 형식입니다. Passport 인증의 경우 사용자 이름은 이메일 주소입니다. 자세한 내용은 설명 부분을 참조하세요.

NULL인 경우 이 세션 컨텍스트에 대한 기본 자격 증명이 사용됩니다.

Password

일반 텍스트로 된 암호를 포함하는 null로 끝나는 문자열입니다. 암호는 null 종결자를 포함하지 않고 65536자로 제한됩니다. 암호는 비워 둘 수 있습니다. UserName이 NULL인 경우 NULL로 설정합니다. BITS는 네트워크 연결이 끊어지거나 사용자가 로그오프하는 경우 작업을 유지하기 전에 암호를 암호화합니다.

라이브 ID로 인코딩된 암호는 협상 2를 통해 지원됩니다. 라이브 ID에 대한 자세한 내용은 Windows Live ID SDK를 참조하세요.

설명

다음 목록에서는 요청된 인증 체계에 따라 UserName 및 Password 멤버가 필요한 시기를 식별합니다.

사용자 이름 및 암호 정보를 보호하려면 Winbase.h에 정의된 SecureZeroMemory 함수를 호출하여 구조를 사용한 후 UserName 및 Password 버퍼를 지웁니다.

다음과 같이 사용자 이름을 지정할 수 있습니다.

  • Domainname\UserName. 서버가 도메인에 있고 DomainName\이 서버가 속해 있거나 신뢰할 수 있는 도메인인 경우 DomainName UserName을 사용합니다.
  • Servername\UserName. 계정이 서버의 로컬 계정인 경우 ServerName\UserName 을 사용합니다. ServerName은 자격 증명을 인증하는 컴퓨터의 이름입니다.
  • UserName. UserName만 지정하면 사용자의 기본 도메인 이름이 사용자 이름 앞에 접두사로 지정되고 DomainName UserName\ 양식에 대한 규칙이 적용됩니다. 사용자가 도메인의 구성원인 경우에만 이 옵션을 사용합니다.
  • NULL. NTLM 또는 Kerberos 인증에 사용자의 로그온 자격 증명을 사용하려면 UserName 을 NULL로 설정합니다. 이는 사용자가 신뢰할 수 있는 도메인에 있는 경우에만 작동합니다. 시스템 계정으로 실행되는 서비스의 경우 UserName 을 NULL 로 설정하면 인증을 위해 컴퓨터의 자격 증명이 전달됩니다. 이 옵션은 도메인이 Kerberos 인증을 사용하도록 설정하고 인증 체계로 협상 을 선택하는 경우에만 작동합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2003
머리글 bits1_5.h(Bits.h 포함)
재배포 가능 파일 Windows XP의 BITS 1.5

추가 정보

BG_AUTH_CREDENTIALS_UNION