Метод IOpcDigitalSignature::GetPackageObjectReference (msopc.h)

Статья
02/29/2024

Возвращает указатель интерфейса IOpcSignatureReference , представляющий ссылку на подписанный элемент Object для конкретного пакета.

Синтаксис

HRESULT GetPackageObjectReference(
  [out, retval] IOpcSignatureReference **packageObjectReference
);

Параметры

[out, retval] packageObjectReference

Указатель интерфейса IOpcSignatureReference , представляющий ссылку на подписанный элемент Object для конкретного пакета.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Параметр packageObjectReference имеет значение NULL.

Указатель интерфейса IOpcSignatureReference , полученный в параметре packageObjectReference , представляет элемент Reference , для которого для атрибута URI задано значение "#idPackageObject". Значение атрибута URI этого элемента является значением атрибута Id для конкретного пакета элемента Object с префиксом фунта ("#").

Когда сигнатура создается и сериализуется как разметка подписи, ссылка и элемент Object , на который ссылается конкретный пакет, подписываются. В следующей разметке показаны зависящий от пакета элемент Reference и элемент Object для конкретного пакета в результирующий разметке сигнатуры.

<!-- Signature markup. -->
<Signature>
    <SignedInfo>
        [...]
        <!-- A reference to the package-specific <Object> that
        is, or will be, signed. -->
        <Reference URI="#idPackageObject">
             [...]
        </Reference>
    </SignedInfo>
    [...]
    <!-- The package-specific <Object> element. -->
    <Object Id="idPackageObject">
        <!-- This element contains the <Reference> elements that
        refer to parts and relationships in the package that are
        or will be signed. -->
        <Manifest>
            [...] 
        </Manifest>
    </Object>
</Signature>

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в статье начало работы с помощью API упаковки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h