ICertAdmin2::GetCAPropertyFlags-Methode (certadm.h)

Artikel
02/23/2024

Die GetCAPropertyFlags-Methode ruft die Eigenschaftsflags für eine Zertifizierungsstelle -Eigenschaft ab. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.

Die Eigenschaftsflags können untersucht werden, um den Datentyp zu bestimmen und zu bestimmen, ob die Eigenschaft indiziert ist.

Syntax

HRESULT GetCAPropertyFlags(
  [in]  const BSTR strConfig,
  [in]  LONG       PropId,
  [out] LONG       *pPropFlags
);

Parameter

[in] strConfig

Stellt eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME dar, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während des Setups der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigGetCAPropertyFlags löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode mit der neuen Konfigurationszeichenfolge erneut aufrufen.

[in] PropId

Gibt den Eigenschaftenbezeichner an. Informationen zu diesem Parameter finden Sie in der Tabelle in ICertAdmin2::GetCAProperty.

[out] pPropFlags

Ein Zeiger auf einen Wert, der die Eigenschaftsflags darstellt.

Rückgabewert

C++

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass die Methode erfolgreich war.

VB

Ein Long-Wert , der die Eigenschaftsflags darstellt.

Hinweise

Der durch Aufrufen dieser Methode abgerufene LONG-Wert kann untersucht werden, um den Datentyp und den indizierten status zu bestimmen. Um den Datentyp und die indizierten status zu bestimmen, verwenden Sie die werte PROPTYPE_MASK bzw. PROPFLAGS_INDEXED.

Beispiele

Im folgenden Beispiel wird davon ausgegangen, dass der ICertAdmin2-Schnittstellenzeiger gültig ist.

BSTR bstrCA = NULL;
LONG nFlags;  // Variable to contain the property flags.

bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
if (NULL == bstrCA)
{
    printf("Failed to allocate memory for bstrCA\n");
    exit(1);
}

// Retrieve a property's flags.
hr = pCertAdmin2->GetCAPropertyFlags(bstrCA,
                                     CR_PROP_EXITCOUNT,
                                     &nFlags);
if (FAILED(hr))
{
    printf("Failed GetCAPropertyFlags\n");
    SysFreeString(bstrCA);
    exit(1);  // Or other error action.
}
// Display the property data type.
switch (nFlags & PROPTYPE_MASK)
{
    case PROPTYPE_BINARY:
        printf("Type is BINARY\n");
        break;
    case PROPTYPE_DATE:
        printf("Type is DATE\n");
        break;
    case PROPTYPE_LONG:
        printf("Type is LONG\n");
        break;
    case PROPTYPE_STRING:
        printf("Type is STRING\n");
        break;
    default:
        printf("Unexpected data type.\n");
        break;
}
// Display the property's indexed status.
printf("Property %s indexed\n", 
       nFlags & PROPFLAGS_INDEXED ? "is" : "is not");

SysFreeString(bstrCA);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll

Freigeben über