BG_BASIC_CREDENTIALS構造体 (bits1_5.h)
認証するユーザー名とパスワードを識別します。
typedef struct __MIDL_IBackgroundCopyJob2_0001 {
LPWSTR UserName;
LPWSTR Password;
} BG_BASIC_CREDENTIALS;
UserName
認証するユーザー名を含む null で終わる文字列。 ユーザー名は 300 文字に制限され、null ターミネータは含まれません。 ユーザー名の形式は、要求された認証スキームによって異なります。 たとえば、Basic、NTLM、Negotiate 認証の場合、ユーザー名は DomainName\UserName という形式になります。 Passport 認証の場合、ユーザー名はメール アドレスです。 詳細については、「解説」を参照してください。
NULL の場合、このセッション コンテキストの既定の資格情報が使用されます。
Password
プレーンテキストでパスワードを含む null で終わる文字列。 パスワードは 65536 文字に制限され、null ターミネータは含まれません。 パスワードは空白にすることができます。 UserName が NULL の場合は NULL に設定します。 BITS は、ネットワーク切断が発生した場合、またはユーザーがログオフした場合に、ジョブを永続化する前にパスワードを暗号化します。
ライブ ID でエンコードされたパスワードは、ネゴシエート 2 を通じてサポートされます。 Live 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 |
Header | bits1_5.h (Bits.h を含む) |
再頒布可能パッケージ | Windows XP の BITS 1.5 |