ldap_next_attribute関数 (winldap.h)
特定のエントリに対して、 ldap_next_attribute 関数は次の属性を返します。
構文
WINLDAPAPI PCHAR LDAPAPI ldap_next_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in, out] BerElement *ptr
);
パラメーター
[in] ld
セッション ハンドル。
[in] entry
ldap_first_entryまたはldap_next_entryによって返される属性をステップ実行するエントリ。
[in, out] ptr
エントリ内の現在位置を追跡するために内部的に使用されるポインターのアドレス。
戻り値
関数が成功すると、現在の属性名を含む null で終わる文字列へのポインターが返されます。 ステップ実行する属性がこれ以上ない場合は、 NULL を返します。 LDAP データ構造のセッション エラー パラメーターは、どちらの場合も 0 に設定されます。
関数が失敗した場合、 NULL が 返され、LDAP データ構造のセッション エラー パラメーターが LDAP エラー コードに設定されます。
注釈
ldap_next_attributeをldap_first_attributeと組み合わせて使用して、エントリで返される属性型の一覧をステップ実行します。 その後、これらの属性名を ldap_get_values の呼び出しで渡して、関連する値を取得できます。
ldap_next_attributeへの呼び出しは、ptr パラメーターを介して BerElement 構造体へのポインターを返します。 このポインターを次の呼び出しに渡して ldap_next_attribute 属性の一覧内の現在の位置を追跡します。 属性の一覧のステップ実行が完了し、 ptr が NULL 以外の場合は、 ber_free (ptr, 0) を呼び出してポインターを解放します。 この呼び出しでは、2 番目のパラメーターを 0 (ゼロ) として渡す必要があることに注意してください。
ldap_next_attribute関数は、現在の属性名を含む内部的に割り当てられたバッファーへのポインターを返します。 ldap_memfreeを呼び出して、不要になった場合は、このバッファー を解放します。 このバッファーは、ldap_first_attributeまたはldap_next_attributeへの次回の呼び出し時に上書きされるため、処理のために属性名を保持する必要がある場合は、その属性名のコピーを作成する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | winldap.h |
Library | Wldap32.lib |
[DLL] | Wldap32.dll |