Compartilhar via


DDRAddStringArray

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

Sintaxe

[IDL]  
HRESULT DDRAddStringArray();  

Parâmetros

sName
Nome da propriedade de classe.

sArray
Matriz de cadeias de caracteres atribuídas à propriedade. Você só pode inserir valores de cadeia de caracteres do conjunto de caracteres de byte único.

nArraySize
Número de elementos em sArray.

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.

dwFlags
Características da propriedade, como um campo de chave usado para comparações. Insira o sinalizador a seguir ou um zero.

Flag Descrição
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.

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

Cadeias de caracteres maiores que o comprimento máximo especificado em nSQLWidth são truncadas.

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 (Data Discovery Manager) 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

DDRAddIntegerArray
DDRAddString
Enumeração DDRPropertyFlagsEnum
Classe de automação SMSResGen COM