DsQuoteRdnValueA 函式 (dsparse.h)

如果 RDN 值包含需要引號的字元， DsQuoteRdnValue 函式會將 RDN 轉換成引號 RDN 值。 然後，您可以使用 LDAP 等各種 API，將引號 RDN 提交為辨別名稱的一部分， (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 函式。

需求

另請參閱

網域控制站和複寫管理功能

DsUnquoteRdnValue