CryptGetObjectUrl 함수(wincrypt.h)

CryptGetObjectUrl 함수는 인증서, CTL(인증서 신뢰 목록) 또는 CRL(인증서 해지 목록)에서 원격 개체의 URL을 가져옵니다.

함수는 개체를 가져와 디코딩하고 개체의 URL 배열에 대한 포인터를 제공합니다. 예를 들어 인증서에서 URL의 CRL 배포 목록은 배열에 있습니다.

구문

BOOL CryptGetObjectUrl(
  [in]      LPCSTR           pszUrlOid,
  [in]      LPVOID           pvPara,
  [in]      DWORD            dwFlags,
  [out]     PCRYPT_URL_ARRAY pUrlArray,
  [in, out] DWORD            *pcbUrlArray,
  [out]     PCRYPT_URL_INFO  pUrlInfo,
  [in, out] DWORD            *pcbUrlInfo,
            LPVOID           pvReserved
);

매개 변수

[in] pszUrlOid

요청되는 URL을 식별하는 OID( 개체 식별자 )에 대한 포인터입니다. pszUrlOid 매개 변수의 HIWORD가 0이면 LOWORD는 지정된 구조체의 형식에 대한 정수 식별자를 지정합니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다. 이러한 값이 pvPara 매개 변수에 미치는 영향에 대한 자세한 내용은 의미 열의 "For the pvPara parameter" 제목을 참조하세요.

[in] pvPara

pszUrlOid 값으로 결정되는 구조체입니다. 자세한 내용은 pszUrlOid 매개 변수에 대한 설명을 참조하세요.

[in] dwFlags

개체의 URL 로케이터를 가져오는 데 사용되는 플래그 집합입니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

[out] pUrlArray

값 항목에 대한 데이터를 수신할 버퍼에 대한 포인터입니다. 이 매개 변수는 데이터를 보관하는 데 필요한 버퍼의 길이를 찾기 위해 NULL 일 수 있습니다.

자세한 내용은 알 수 없는 길이의 데이터 검색을 참조하세요.

[in, out] pcbUrlArray

pUrlArray 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 DWORD에 대한 포인터입니다. 함수가 반환되면 DWORD 에는 버퍼에 저장된 바이트 수가 포함됩니다. 이 매개 변수는 pUrlArray가 NULL인 경우에만 NULL일 수 있습니다.

[out] pUrlInfo

값 항목에 대한 데이터를 수신하는 CRYPT_URL_INFO 구조체에 대한 선택적 포인터입니다.

[in, out] pcbUrlInfo

pUrlArray 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 DWORD에 대한 포인터입니다. 함수가 반환되면 DWORD 에는 버퍼에 저장된 바이트 수가 포함됩니다.

pvReserved

나중에 사용하도록 예약되며 NULL이어야 합니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값(TRUE)을 반환합니다.

함수가 실패하면 0(FALSE)을 반환합니다. 확장 오류 정보는 GetLastError를 호출합니다.

요구 사항

추가 정보

원격 개체 검색 함수