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

Artigo
02/29/2024

Obtém um valor que indica se uma parte especificada é representada como um objeto de parte no conjunto.

Sintaxe

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

Parâmetros

[in] name

Um ponteiro para um IOpcPartUri que representa o nome da parte da parte.

[out, retval] partExists

Um dos seguintes valores:

Valor	Significado
TRUE	Uma parte que tem o nome da parte especificada é representada no conjunto.
FALSE	Uma parte que tem o nome da parte especificada não está representada no conjunto.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro partExists é NULL.
Erro de consumo de pacote	Um código de erro HRESULT do Grupo de Erros de Consumo de Pacote.
Erro de URI de parte	Um código de erro HRESULT do Grupo de Erros do URI de Parte.

Comentários

Para recuperar o ponteiro da interface IOpcPart do objeto part que representa uma parte específica, chame o método PartExists e passe o nome da parte para confirmar se a parte está representada no conjunto. Se for, chame o método GetPart e passe o nome da parte para recuperar o ponteiro da interface IOpcPart .

Se o nome da parte representada for o nome de uma parte Relações, partExists receberá FALSE porque as partes Relações não estão incluídas no conjunto.

Se uma parte for representada no conjunto, a parte existirá no pacote que está sendo lido ou no pacote a ser gravado.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h