DsQuoteRdnValueA 関数 (dsparse.h)

DsQuoteRdnValue 関数は、RDN 値に引用符を必要とする文字が含まれている場合、RDN を引用符で囲まれた RDN 値に変換します。 その後、LDAP などのさまざまな API を使用して、引用符で囲まれた RDN を識別名 (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 は、RFC 2253 の仕様 「Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names」(ライトウェイト ディレクトリ アクセス プロトコル (v3): UTF-8 String Representation of Distinguished Names) に従って引用符で囲まれます。

入力 RDN 値と出力 RDN 値は、NULL-terminated 文字列 されません。

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

必要条件

関連項目

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

DsUnquoteRdnValue