Método IOpcRelationshipSelector::GetSelectionCriterion (msopc.h)

Artigo
08/25/2023

Obtém uma cadeia de caracteres usada para selecionar relações a serem referenciadas para assinatura.

Sintaxe

HRESULT GetSelectionCriterion(
  [out, retval] LPWSTR *selectionCriterion
);

Parâmetros

[out, retval] selectionCriterion

Uma cadeia de caracteres usada para selecionar relações a serem referenciadas para assinatura.

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 selectionCriterion é NULL.

Comentários

Esse método aloca memória usada pela cadeia de caracteres retornada em selectionCriterion. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória.

Use os métodos de interface IOpcRelationshipSelector para selecionar relações para assinatura. Uma relação será selecionada se seu tipo ou identificador corresponder à cadeia de caracteres recuperada chamando o método GetSelectionCriterion . Essa cadeia de caracteres é um tipo de relação ou um identificador de relação. Chame o método GetSelectorType para obter um valor OPC_RELATIONSHIP_SELECTOR para determinar se a cadeia de caracteres é um tipo de relação ou um identificador. Para acessar essas propriedades de relação, chame os métodos IOpcRelationship::GetRelationshipType e IOpcRelationship::GetId .

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