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

こちらもご覧ください

BG_AUTH_CREDENTIALS_UNION