如果 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 |