通过

DsQuoteRdnValueA 函数 （dsparse.h）

  • 项目

如果 RDN 值包含需要引号的字符，则 DsQuoteRdnValue 函数将 RDN 转换为带引号的 RDN 值。 然后，可以使用各种 API（例如 LDAP）将带引号的 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 函数。

注意

dsparse.h 标头将 DsQuoteRdnValue 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 dsparse.h （包括 Ntdsapi.h）
库 Ntdsapi.lib
DLL Ntdsapi.dll

另请参阅

域控制器和复制管理功能

DsUnquoteRdnValue