IOpcSigningOptions::SetTimeFormat method (msopc.h)

Sets the format of the string retrieved by the IOpcDigitalSignature::GetSigningTime method.

Syntax

HRESULT SetTimeFormat(
  [in] OPC_SIGNATURE_TIME_FORMAT timeFormat
);

Parameters

[in] timeFormat

The value that describes the format of the string retrieved by the IOpcDigitalSignature::GetSigningTime method.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_INVALIDARG
The value passed in the timeFormat parameter is not a valid OPC_SIGNATURE_TIME_FORMAT enumeration value.

Remarks

This method changes the format of the signing time string from the default format, OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS, to a format that is specified by the caller.

To access the format of the signing time string before the signature is generated, call the IOpcSigningOptions::GetTimeFormat method. To access the format after the signature has been generated, call the IOpcDigitalSignature::GetTimeFormat method.

Thread Safety

Packaging objects are not thread-safe.

For more information, see the Getting Started with the Packaging API.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header msopc.h

See also

Core Packaging Interfaces

Getting Started with the Packaging API

IOpcDigitalSignature

IOpcSigningOptions

OPC_SIGNATURE_TIME_FORMAT

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference