共用方式為

DsQuoteRdnValueA 函式 （dsparse.h）

  • 發行項

如果 RDN 值包含需要引號的字元，則 DsQuoteRdnValue 函式會將 RDN 轉換成引號 RDN 值。 接著，引號 RDN 可以使用 LDAP 等各種 API，將辨別名稱 （DN） 提交至目錄服務。 需要引號的 RDN 範例會是具有逗號分隔值的 RDN，例如使用 「last，first」 格式的名稱 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 會根據規格來加上引號「羽量型目錄存取通訊協定（v3）：UTF-8 字串表示辨別名稱」，RFC 2253。

輸入和輸出 RDN 值不會 NULL終止字串。

若要還原此呼叫所做的變更，請呼叫 DsUnquoteRdnValue 函式。

注意

dsarse.h 標頭會將 DsQuoteRdnValue 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows Server 2008
目標平臺 窗戶
標頭 dsparse.h （包括 Ntdsapi.h）
連結庫 Ntdsapi.lib
DLL Ntdsapi.dll

另請參閱

域控制器和復寫管理功能

DsUnquoteRdnValue