다음을 통해 공유


SignerTimeStampEx3 함수

SignerTimeStampEx3 함수는 지정된 제목에 스탬프를 지정하고 여러 서명에 타임스탬프 설정을 지원합니다.

참고

이 함수에는 연결된 헤더 파일 또는 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 사용자 정의 헤더 파일을 만들고 LoadLibraryGetProcAddress 함수를 사용하여 Mssign32.dll 동적으로 연결해야 합니다.

 

구문

HRESULT WINAPI SignerTimeStampEx3(
  _In_       DWORD                  dwFlags,
  _In_       DWORD                  dwIndex,
  _In_       SIGNER_SUBJECT_INFO    *pSubjectInfo,
  _In_       PCWSTR                 pwszHttpTimeStamp,
  _In_       PCWSTR                 pszAlgorithmOid,
  _In_opt_   PCRYPT_ATTRIBUTES      psRequest,
  _In_opt_   PVOID                  pSipData,
  _Out_      SIGNER_CONTEXT         **ppSignerContext,
  _In_opt_   PCERT_STRONG_SIGN_PARA pCryptoPolicy,
  _Reserved_ PVOID                  pReserved
);

매개 변수

dwFlags [in]

생성할 타임스탬프를 지정하는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다. 값은 상호 배타적입니다.

의미
SIGNER_TIMESTAMP_AUTHENTICODE
Authenticode 타임스탬프를 지정합니다.
참고: Authenticode는 더 이상 기본 설정 타임스탬프를 사용하지 않습니다. Authenticode 타임스탬프는 나중에 제거될 수 있습니다. 대신 RFC 3161을 사용하는 것이 좋습니다.
SIGNER_TIMESTAMP_RFC3161
RFC 3161 규격 타임스탬프를 지정합니다.

 

dwIndex [in]

타임스탬프를 추가할 서명의 시퀀스 번호를 지정합니다. 이 값이 0이면 외부 서명에 타임스탬프를 적용합니다.

pSubjectInfo [in]

타임스탬프를 적용할 제목을 나타내는 SIGNER_SUBJECT_INFO 구조체의 주소입니다.

pwszHttpTimeStamp [in]

타임스탬핑 서버의 URL을 포함하는 null로 끝나는 유니코드 문자열의 주소입니다.

pszAlgorithmOid [in]

RFC 3161 규격 타임스탬프를 수행하는 데 사용할 해시 알고리즘입니다. Authenticode 타임스탬프는 이 매개 변수가 무시됩니다.

psRequest [in, optional]

선택 사항입니다. 타임스탬핑 요청에 추가되는 추가 특성을 포함하는 CRYPT_ATTRIBUTES 구조체의 주소입니다.

이 매개 변수는 선택 사항이며 포함되지 않은 경우 NULL 일 수 있습니다.

pSipData [in, optional]

선택 사항입니다. SIP( 주체 인터페이스 패키지 ) 함수에 추가 데이터로 전달되는 32비트 값입니다. 이 매개 변수의 형식과 콘텐츠는 SIP 공급자에 의해 정의됩니다.

이 매개 변수는 선택 사항이며 포함되지 않은 경우 NULL 일 수 있습니다.

ppSignerContext [out]

선택 사항입니다. 서명된 BLOB을 포함하는 SIGNER_CONTEXT 구조체에 대한 포인터의 주소입니다. SIGNER_CONTEXT 구조체 사용을 마치면 SignerFreeSignerContext 함수를 호출하여 해제합니다.

pCryptoPolicy [in, optional]

있는 경우 강력한 서명을 위해 검사 데 사용되는 매개 변수를 포함하는 CERT_STRONG_SIGN_PARA 구조체에 대한 포인터입니다. 타임스탬프는 이 암호화 정책을 통과해야 합니다.

보존

예약되어 있습니다. 이 값은 NULL이어야 합니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 이 함수에서 반환할 수 있는 오류 코드는 다음과 같습니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

반환 코드 설명
E_INVALIDARG
이 오류는 다음 조건에 대해 반환될 수 있습니다.
  • dwFlags 매개 변수에 대해 SIGNER_TIMESTAMP_AUTHENTICODE 또는 SIGNER_TIMESTAMP_RFC3161 설정해야 합니다.
  • pReserved 매개 변수는 NULL이어야 합니다.
  • dwFlags 매개 변수에서 SIGNER_TIMESTAMP_AUTHENTICODE 플래그를 설정하는 경우 dwIndex 매개 변수를 0으로 설정해야 합니다.

 

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2012 [데스크톱 앱만 해당]
DLL
Mssign32.dll

추가 정보

SignerTimeStamp

SignerTimeStampEx

SignerTimeStampEx2