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

Artículo
02/29/2024

Crea un objeto URI de parte que representa un nombre de elemento.

Sintaxis

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

Parámetros

[in] pwzUri

Un URI que representa la ubicación de una parte relativa a la raíz del paquete que lo contiene.

[out, retval] partUri

Puntero a la interfaz IOpcPartUri del objeto URI de parte. Este objeto representa el nombre de elemento derivado del URI pasado en pwzUri.

Los nombres de los elementos deben ajustarse a la sintaxis especificada en el OPC.

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 o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	Al menos uno de los parámetros pwzUri y partUri es NULL.
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede ser la cadena vacía "".
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede ser "/".
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede comenzar por "//".
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede terminar con "/".
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede terminar con '.'.
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede tener segmentos que terminen con ".".
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de elemento no puede tener un componente de fragmento. Un componente de fragmento está precedido por un carácter "#", como se describe en RFC 3986: Sintaxis genérica de URI.
OPC_E_NONCONFORMING_URI 0x80510001	Un nombre de pieza no puede ser el nombre de una parte De relaciones que indica otra parte relaciones como origen de las relaciones contenidas en él.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	Un nombre de elemento no puede ser un URI absoluto. Un URI absoluto comienza con un componente de esquema seguido de ":", como se describe en RFC 3986: Sintaxis genérica de URI.
Error de la función CreateUri	Código de error HRESULT de la función CreateUri .
Error de WinINet	Código de error HRESULT de una API de WinINet .

Comentarios

Compatibilidad con versiones anteriores de Windows

El comportamiento y el rendimiento de este método son los mismos en todas las versiones de Windows compatibles. Para obtener más información, consulte Introducción con la API de empaquetado y Actualización de plataforma para Windows Vista.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h