Windows Dev Center

BCRYPT_OID_LIST structure

The BCRYPT_OID_LIST structure is used to contain a collection of BCRYPT_OID structures. Use this structure with the BCRYPT_HASH_OID_LIST property to retrieve the list of hashing object identifiers (OIDs) that have been encoded by using Distinguished Encoding Rules (DER) encoding.

Syntax


typedef struct _BCRYPT_OID_LIST {
  ULONG      dwOIDCount;
  BCRYPT_OID *pOIDs;
} BCRYPT_OID_LIST;

Members

dwOIDCount

The number of elements in the pOIDs array.

pOIDs

The address of an array of BCRYPT_OID structures that contains OIDs.

Remarks

The first OID in the pOIDs array is used to identify any hashes or signatures created by this algorithm provider. When verifying a hash or signature, all the OIDs in the array are treated as valid.

In the Microsoft Primitive Provider implementation, dwOIDCount is 2, so that the pOIDs array contains two members:

  • pOIDs[0] contains a DER-encoded AlgorithmIdentifier with a NULL parameter.
  • pOIDs[1] contains the DER-encoded AlgorithmIdentifier without a NULL parameter.

For example, the SHA-1 encoding would be:

  • pOIDs[0] --> 06 05 2b 0e 03 02 1a 05 00
  • pOIDs[1] --> 06 05 2b 0e 03 02 1a

The following snippet describes an AlgorithmIdentifier in Abstract Syntax Notation One (ASN.1) notation. SEQUENCE, OBJECT IDENTIFIER, and ANY are DER encoded. The ANY BLOB is NULL.

AlgorithmIdentifier ::= SEQUENCE {
   algorithm            OBJECT IDENTIFIER,
   algorithmParams      ANY
}

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Bcrypt.h

See also

BCRYPT_OID
BCryptGetProperty
Cryptography Primitive Property Identifiers

 

 

Community Additions

ADD
Show:
© 2015 Microsoft