DsQuoteRdnValueA 関数 (dsparse.h)

RDN 値に引用符を必要とする文字が含まれている場合、 DsQuoteRdnValue 関数は RDN を引用符で囲まれた RDN 値に変換します。 その後、引用符で囲まれた RDN は、LDAP などのさまざまな API を使用して、識別名 (DN) の一部としてディレクトリ サービスに送信できます。 引用符を必要とする RDN の例としては、"last,first" という形式を使用する名前の RDN など、コンマ区切りの値を持つ RDN があります。

構文

DSPARSE DWORD DsQuoteRdnValueA(
  [in]      DWORD cUnquotedRdnValueLength,
  [in]      LPCCH psUnquotedRdnValue,
  [in, out] DWORD *pcQuotedRdnValueLength,
  [out]     LPCH  psQuotedRdnValue
);

パラメーター

[in] cUnquotedRdnValueLength

psUnquotedRdnValue 文字列内の文字数。

[in] psUnquotedRdnValue

引用符で囲まれていない RDN 値を指定する文字列。

[in, out] pcQuotedRdnValueLength

psQuotedRdnValue 文字列内の最大文字数。

このパラメーターの出力は、次のフラグです。

ERROR_SUCCESS

psQuotedRdnValue で正しい文字数が見つかったことを示します。

ERROR_BUFFER_OVERFLOW

文字列内の文字数が psQuotedRdnValue と一致しないことを示します。

[out] psQuotedRdnValue

変換された RDN 値 (引用符で囲まれた) を受け取る文字列。

戻り値

次の一覧には、 DsQuoteRdnValue 関数で返される可能性のある値が含まれています。

解説

必要がない場合、引用符は RDN に追加されません。 この場合、出力 RDN 値は入力 RDN 値と同じです。

引用符が必要な場合、RDN は、仕様 「Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names」RFC 2253 に従って引用符で囲まれます。

入力と出力の RDN 値は NULL で終わる文字列ではありません。

この呼び出しによって行われた変更を元に戻すには、 DsUnquoteRdnValue 関数を呼び出します。

注意

dsparse.h ヘッダーは、DSQuoteRdnValue をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	dsparse.h (Ntdsapi.h を含む)
Library	Ntdsapi.lib
[DLL]	Ntdsapi.dll

関連項目

ドメイン コントローラーとレプリケーション管理機能

DsUnquoteRdnValue