DDRAddString

A DDRAddString função, no 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 class.

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 esta propriedade. Esse valor não inclui o caractere NULL. Para SMS 2003 Esse valor não pode ser maior que 900 caracteres. Para o 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 do Configuration Manager. Esse sinalizador é usado apenas na SMSUniqueIdentifier propriedade. Se você usa ADDPROP_GUID, também deve usar ADDPROP_KEY. 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-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 será criada.
ADDPROP_NAME (Hexadecimal 44)	Instrui o DDM (Data Discovery Manager) a usar o valor da cadeia de caracteres dessa propriedade para o valor da Namepropriedade. A Name propriedade é uma das seis outras propriedades geradas para você pelo DDM.
ADDPROP_NAME2 (Hexadecimal 84)	Adiciona uma Comment propriedade à sua DDR e usa o valor da 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 BDRNovo não tiver sido chamada, o valor retornado será S_FALSE.

Comentários

Seu DDR deve conter uma propriedade de cadeia de caracteres que especifique 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 do que o comprimento máximo especificado em nSQLWidth.

Você pode usar sublinhados, concatenação ou espaços para nomes de propriedade que contenham várias palavras. Por exemplo, você pode especificar sName como License_Number, LicenseNumber, ou 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 tempo de execução

smsrsgenctl.dll

smsrsgen.dll

Para obter mais informações, consulte Requisitos de tempo de execução do servidor do Configuration Manager.

Requisitos de desenvolvimento

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

Confira também

DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum EnumeraçãoSMSResGen COM Classe de AutomaçãoInterface ISMSResGen