Método IOpcFactory::CreatePartUri (msopc.h)

Cria um objeto URI de parte que representa um nome de parte.

Sintaxe

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

[in] pwzUri

Um URI que representa o local de uma parte em relação à raiz do pacote que o contém.

[out, retval] partUri

Um ponteiro para a interface IOpcPartUri do objeto URI da parte. Esse objeto representa o nome da parte derivado do URI passado em pwzUri.

Os nomes de parte devem estar em conformidade com a sintaxe especificada no OPC.

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

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos parâmetros pwzUri e partUri é NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode ser a cadeia de caracteres vazia "".
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode ser um '/'.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode começar com "//".
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode terminar com um '/'.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode terminar com um '.'.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode ter segmentos que terminem com um '.'.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode ter componente de fragmento. Um componente de fragmento é precedido por um caractere '#', conforme descrito em RFC 3986: Sintaxe genérica de URI.
OPC_E_NONCONFORMING_URI 0x80510001	Um nome de parte não pode ser o nome de uma parte Relações que indica outra parte Relações como a origem das relações contidas nela.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Um nome de parte não pode ser um URI absoluto. Um URI absoluto começa com um componente de esquema seguido por um ":", conforme descrito em RFC 3986: Sintaxe genérica de URI.
Erro de função CreateUri	Um código de erro HRESULT da função CreateUri .
Erro winINet	Um código de erro HRESULT de uma API WinINet .

O comportamento e o desempenho desse método são os mesmos em todas as versões com suporte do Windows. Para obter mais informações, consulte Introdução com a API de Empacotamento e Atualização de Plataforma para Windows Vista.

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

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

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h