dsQuoteRdnValueA 函数 (dsparse.h)
如果 RDN 值包含需要引号的字符， DsQuoteRdnValue 函数会将 RDN 转换为带引号的 RDN 值。 然后，可以使用 LDAP 等各种 API 将带引号的 RDN 作为可分辨名称的一部分提交 (DN) 到目录服务。 需要引号的 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 值相同。
需要引用时，将按照规范“轻型目录访问协议 (v3) ：可分辨名称的 UTF-8 字符串表示形式”RFC 2253 引用 RDN。
输入和输出 RDN 值不是 以 NULL 结尾的字符串。
若要还原此调用所做的更改，请调用 DsUnquoteRdnValue 函数。
注意
dsparse.h 标头将 DsQuoteRdnValue 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | dsparse.h (包括 Ntdsapi.h) |
| Library | Ntdsapi.lib |
| DLL | Ntdsapi.dll |