DDRAddString

A DDRAddString função, em Configuration Manager, adiciona uma propriedade de cadeia de caracteres ao DDR (registro de descoberta de dados).

Sintaxe

[IDL]  
HRESULT DDRAddString();  

Parâmetros

Name
Nome da propriedade de classe.

sValue
Valor atribuído à propriedade. Você só pode inserir valores de cadeia de caracteres do conjunto de caracteres de byte único.

nSQLWidth
Comprimento máximo de uma cadeia de caracteres que pode ser atribuída a essa propriedade. Esse valor não inclui o caractere NULL. Para SMS 2003 Esse valor não pode ser maior que 900 caracteres. Para SMS 2.0, esse valor não pode ser maior que 255 caracteres.

Flags
Características da propriedade, como um campo-chave para comparações. Insira um ou mais dos sinalizadores a seguir ou um zero.

Flag	Descrição
ADDPROP_GUID (Hexadecimal 2)	Identifica uma propriedade que é constante e identifica exclusivamente o item descoberto. Se especificado para DDRs do sistema, este deve ser o SMSID gerado pelo cliente Configuration Manager. Esse sinalizador só é usado na SMSUniqueIdentifier propriedade. Se você usar ADDPROP_GUID, também deve usar ADDPROP_KEY. Observe que SMSUniqueIdentifier relaciona dados de descoberta a dados de inventário. Se você não coletar informações de inventário para esse recurso, não precisará especificar a SMSUniqueIdentifierpropriedade em seu DDR.
ADDPROP_KEY (Hexadecimal 8)	Identifica essa propriedade como um campo de chave durante uma comparação desse DDR com instâncias de classe no banco de dados. Se uma instância no banco de dados corresponder aos dados das propriedades da chave DDR, a instância será atualizada; caso contrário, uma nova instância é criada.
ADDPROP_NAME (Hexadecimal 44)	Informa ao DDM (Data Discovery Manager) para usar o valor de cadeia de caracteres dessa propriedade para o valor da Namepropriedade. A Name propriedade é uma das seis propriedades adicionais que são geradas para você pelo DDM.
ADDPROP_NAME2 (Hexadecimal 84)	Adiciona uma Comment propriedade ao DDR e usa o valor de cadeia de caracteres de sua propriedade para seu valor.

Return Values

Se a função for bem-sucedida, o valor retornado será S_OK.

Se a função DDRNew não tiver sido chamada, o valor retornado será S_FALSE.

Comentários

O DDR deve conter uma propriedade de cadeia de caracteres que especifica o sinalizador ADDPROP_NAME. O valor deve identificar exclusivamente o recurso porque a Name propriedade normalmente é usada para consultar dados de recursos.

O DDR será rejeitado se sValue for maior que o comprimento máximo especificado em nSQLWidth.

Você pode usar sublinhados, concatenação ou espaços para nomes de propriedades que contêm várias palavras. Por exemplo, você pode especificar sName como License_Number, LicenseNumberou LicenseNumber. Se você especificar sName como LicenseNumber, o DDM concatena as palavras, o que resulta em LicenseNumber. No entanto, o nome da coluna, que é criado no banco de dados, é License_Number. Você deve usar a mesma convenção ao adicionar DDRs que criam ou atualizam instâncias em uma classe de recurso existente.

Requisitos

Requisitos de runtime

smsrsgenctl.dll

smsrsgen.dll

Para obter mais informações, consulte Configuration Manager Requisitos de Runtime do Servidor.

Requisitos de desenvolvimento

Para obter mais informações, consulte Configuration Manager Requisitos de Desenvolvimento do Servidor.

Confira também

DDRAddInteger
DDRAddStringArray
Enumeração DDRPropertyFlagsEnum
Classe de automação SMSResGen COM
ISMSResGen Interface