CryptCATCDFEnumAttributesWithCDFTag 함수

[ CryptCATCDFEnumAttributesWithCDFTag 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

CryptCATCDFEnumAttributesWithCDFTag 함수는 CDF(카탈로그 정의 파일)의 CatalogFiles 섹션에서 멤버 파일의 특성을 열거합니다. CryptCATCDFEnumAttributesWithCDFTag 는 MakeCat에서 호출됩니다.

구문

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

매개 변수

pCDF [in]

CRYPTCATCDF 구조체에 대한 포인터입니다.

pwszMemberTag [in]

카탈로그 파일 멤버를 식별하는 null로 끝나는 문자열에 대한 포인터입니다.

pMember [in]

멤버 정보를 포함하는 CRYPTCATMEMBER 구조체에 대한 포인터입니다.

pPrevAttr [in]

pCDF가 가리키는 CDF의 파일 멤버 특성에 대한 CRYPTCATATTRIBUTE 구조체에 대한 포인터입니다.

pfnParseError [in]

파일 구문 분석 오류를 처리하는 사용자 정의 함수에 대한 포인터입니다.

반환 값

성공하면 이 함수는 CRYPTCATATTRIBUTE 구조체에 대한 포인터를 반환합니다. CryptCATCDFEnumAttributesWithCDFTag 함수는 실패할 경우 NULL 포인터를 반환합니다.

설명

일반적으로 루프에서 이 함수를 호출하여 CDF의 모든 카탈로그 파일 멤버 특성을 열거합니다. 루프를 입력하기 전에 pPrevAttr 을 NULL로 설정합니다. 함수는 첫 번째 특성에 대한 포인터를 반환합니다. 루프의 후속 반복을 위해 pPrevAttr 을 함수의 반환 값으로 설정합니다.

예제

다음 예제에서는 pPrevAttr 매개 변수(pAttr)에 대한 올바른 할당 시퀀스를 보여 줍니다.

    CRYPTCATATTRIBUTE   *pAttr;
    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L"myCDF", NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        pAttr = NULL;

        while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
                                                           pwszMemberTag,
                                                           pMember,
                                                           pAttr,
                                                           DisplayParseError))
        {
            //do something with pAttr
        }

    }

    CryptCATCDFClose(pCDF);

요구 사항

추가 정보

MakeCat

CRYPTCATATTRIBUTE

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary