DDRAddString

La DDRAddString función, en Configuration Manager, agrega una propiedad de cadena al registro de detección de datos (DDR).

Sintaxis

[IDL]  
HRESULT DDRAddString();  

Parámetros

Name
Nombre de la propiedad de clase.

sValue
Valor asignado a la propiedad . Solo puede escribir valores de cadena del juego de caracteres de un solo byte.

nSQLWidth
Longitud máxima de una cadena que se puede asignar a esta propiedad. Este valor no incluye el carácter NULL. Para SMS 2003 Este valor no puede tener más de 900 caracteres. Para SMS 2.0, este valor no puede tener más de 255 caracteres.

Flags
Características de la propiedad, como un campo clave para las comparaciones. Escriba una o varias de las siguientes marcas o un cero.

Flag	Descripción
ADDPROP_GUID (hexadecimal 2)	Identifica una propiedad que es constante e identifica de forma única el elemento detectado. Si se especifica para los DDR del sistema, debe ser el SMSID generado por el cliente de Configuration Manager. Esta marca solo se usa en la SMSUniqueIdentifier propiedad . Si usa ADDPROP_GUID, también debe usar ADDPROP_KEY. Tenga en cuenta que SMSUniqueIdentifier relaciona los datos de detección con los datos de inventario. Si no recopila información de inventario para este recurso, no es necesario especificar la propiedad en el SMSUniqueIdentifierDDR.
ADDPROP_KEY (hexadecimal 8)	Identifica esta propiedad como un campo clave durante una comparación de este DDR con instancias de clase en la base de datos. Si una instancia de la base de datos coincide con los datos de las propiedades de clave DDR, la instancia se actualiza; De lo contrario, se crea una nueva instancia.
ADDPROP_NAME (hexadecimal 44)	Indica al Administrador de detección de datos (DDM) que use el valor de cadena de esta propiedad para el valor de la Namepropiedad. La Name propiedad es una de las seis propiedades adicionales que genera el DDM.
ADDPROP_NAME2 (Hexadecimal 84)	Agrega una Comment propiedad a ddr y usa el valor de cadena de la propiedad para su valor.

Valores devueltos

Si la función se realiza correctamente, el valor devuelto se S_OK.

Si no se ha llamado a la función DDRNew , se S_FALSE el valor devuelto.

Comentarios

El DDR debe contener una propiedad de cadena que especifique la marca de ADDPROP_NAME. El valor debe identificar de forma única el recurso porque la Name propiedad se usa normalmente para consultar los datos del recurso.

El DDR se rechaza si sValue es mayor que la longitud máxima especificada en nSQLWidth.

Puede usar caracteres de subrayado, concatenación o espacios para nombres de propiedad que contengan varias palabras. Por ejemplo, puede especificar sName como License_Number, LicenseNumbero LicenseNumber. Si especifica sName como , el DDM concatena las palabras, lo que da como LicenseNumberresultado LicenseNumber. Sin embargo, el nombre de columna, que se crea en la base de datos, es License_Number. Debe usar la misma convención al agregar DDR que crean o actualizan instancias en una clase de recursos existente.

Requisitos

Requisitos del entorno de ejecución

smsrsgenctl.dll

smsrsgen.dll

Para obtener más información, consulte requisitos de tiempo de ejecución de Configuration Manager Server.

Requisitos de desarrollo

Para obtener más información, consulte requisitos de desarrollo de Configuration Manager Server.

Consulta también

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum (enumeración)
SMSResGen COM Automation (clase)
Interfaz ISMSResGen