Método IOpcPartSet::P artExists (msopc.h)

Artículo
02/29/2024

Obtiene un valor que indica si una parte especificada se representa como un objeto de elemento en el conjunto.

Sintaxis

HRESULT PartExists(
  [in]          IOpcPartUri *name,
  [out, retval] BOOL        *partExists
);

Parámetros

[in] name

Puntero a un IOpcPartUri que representa el nombre de la parte del elemento.

[out, retval] partExists

Uno de los siguientes valores:

Valor	Significado
TRUE	Un elemento que tiene el nombre del elemento especificado se representa en el conjunto.
FALSE	Un elemento que tiene el nombre del elemento especificado no se representa en el conjunto.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro partExists es NULL.
Error de consumo de paquetes	Código de error HRESULT del grupo de errores de consumo de paquetes.
Error de URI de parte	Código de error HRESULT del grupo de errores del URI de parte.

Comentarios

Para recuperar el puntero de interfaz IOpcPart del objeto de elemento que representa una parte específica, llame al método PartExists y pase el nombre del elemento para confirmar que la parte está representada en el conjunto. Si es así, llame al método GetPart y pase el nombre del elemento para recuperar el puntero de interfaz IOpcPart .

Si el nombre del elemento representado es el nombre de un elemento Relationships, partExists recibe FALSE porque los elementos Relationships no se incluyen en el conjunto.

Si un elemento se representa en el conjunto, el elemento existe en el paquete que se va a leer o el paquete que se va a escribir.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h