Metodo IContactProperties::CreateArrayNode (icontact.h)

Crea un nuovo nodo matrice in una proprietà multivalore.

Sintassi

HRESULT CreateArrayNode(
  [in]      LPCWSTR pszArrayName,
  [in]      DWORD   dwFlags,
  [in]      BOOL    fAppend,
  [in, out] LPWSTR  pszNewArrayElementName,
  [in]      DWORD   cchNewArrayElementName,
  [in, out] DWORD   *pdwcchNewArrayElementNameRequired
);

Parametri

[in] pszArrayName

Tipo: LPCWSTR

Specifica la proprietà di primo livello per cui creare un nuovo nodo.

[in] dwFlags

Tipo: DWORD

Deve essere CGD_DEFAULT.

[in] fAppend

Tipo: BOOL

TRUE per l'inserimento dopo, FALSE per l'inserimento prima.

[in, out] pszNewArrayElementName

Tipo: LPWSTR

Specifica un buffer allocato dall'utente per archiviare il nuovo nome dell'elemento della matrice.

[in] cchNewArrayElementName

Tipo: DWORD

Specifica una dimensione del buffer allocata in caratteri.

[in, out] pdwcchNewArrayElementNameRequired

Tipo: DWORD*

In caso di errore, contiene le dimensioni necessarie per pszNewArrayElementName.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Il nuovo nodo viene creato e il nome è in pszNewArrayElementName.
ERROR_PATH_NOT_FOUND	La macro HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) restituita quando il nome della matrice non è valido.
ERROR_INSUFFICIENT_BUFFER	Macro HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) restituita quando pszNewArrayElementName non è abbastanza grande per archiviare il valore. Le dimensioni del buffer necessarie vengono archiviate in pdwcchNewArrayElementNameRequired.

Commenti

Nota Il primo elemento di un set esistente è in corrispondenza dell'indice 1.

 

Per creare un pszArrayName in toplevel/secondlevel[1], chiamare questa funzione con pszArrayName == toplevel, fAppend=FALSE.

Per creare un nodo di matrice che è un'estensione in [spazio dei nomi]toplevel/secondlevel[1], chiamare questa funzione con pszArrayName == [namespace:secondlevel]toplevel.

Per aggiungere al set, passare invece fAppend=TRUE; pszNewArrayElementName contiene quindi il nome del nodo della matrice risultante, incluso l'indice.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	icontact.h (include Contact.h)
DLL	Wab32.dll (versione 6.0 o successiva)