ldap_sasl_bind_sA関数 (winldap.h)
ldap_sasl_bind_s関数は、SASL を使用して LDAP サーバーに対してクライアントを認証する同期関数です。
構文
WINLDAPAPI INT LDAPAPI ldap_sasl_bind_sA(
[in] LDAP *ExternalHandle,
[in] const PSTR DistName,
[in] const PSTR AuthMechanism,
[in] const BERVAL *cred,
[in] PLDAPControlA *ServerCtrls,
[in] PLDAPControlA *ClientCtrls,
[out] PBERVAL *ServerData
);
パラメーター
[in] ExternalHandle
セッション ハンドル。
[in] DistName
バインドに使用されるエントリの識別名。
[in] AuthMechanism
使用する認証方法を示します。
[in] cred
認証に使用する資格情報。 このパラメーターを使用して、任意の資格情報を渡すことができます。 資格情報の形式と内容は、渡された AuthMechanism 引数の値によって異なります。 詳細については、「解説」を参照してください。
[in] ServerCtrls
LDAP サーバー コントロールの一覧。
[in] ClientCtrls
LDAP クライアント コントロールの一覧。
[out] ServerData
バインド要求に応答してサーバーから返される認証データ。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値」を参照してください。
解説
ldap_sasl_bind_s関数は、簡易認証およびセキュリティ層 (SASL) プロトコルを使用して LDAP サーバーにバインドします。 バインド操作では、識別名と何らかの種類の認証資格情報を指定して、クライアントをディレクトリ サーバーに識別します。 使用される認証方法によって、特定の種類の資格情報が決定され、 AuthMechanism 引数で指定されます。 これは、"GSSAPI"、"GSS-SPNEGO"、"DIGEST-MD5" などの形式の文字列として渡されます。 この関数を使用して任意の資格情報をサーバーに渡すことができるため、アプリケーションはサーバーから返された応答を解釈する準備ができている必要があります。
注意
winldap.h ヘッダーは、ldap_sasl_bind_sをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |