IRecordInfo::GetFieldNames-Methode (oaidl.h)
Ruft die Namen der Felder des Datensatzes ab.
Syntax
HRESULT GetFieldNames(
[in, out] ULONG *pcNames,
[out] BSTR *rgBstrNames
);
Parameter
[in, out] pcNames
Die Anzahl der zurückzugebenden Namen.
[out] rgBstrNames
Der Name des Arrays vom Typ BSTR.
Wenn der rgBstrNames-Parameter NULL ist, wird pcNames mit der Anzahl der Feldnamen zurückgegeben.
Der rgBstrNames-Parameter ist nicht NULL, dann werden die in rgBstrNames enthaltenen Zeichenfolgennamen zurückgegeben. Wenn die Anzahl der Namen in pcNames und rgBstrNames nicht gleich ist, ist die geringere Anzahl der beiden die Anzahl der zurückgegebenen Feldnamen. Der Aufrufer muss die BSTRs innerhalb des Arrays freigeben, das in rgBstrNames zurückgegeben wird.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Nicht genügend Arbeitsspeicher. |
|
Mindestens eines der Argumente ist ungültig. |
Hinweise
Der Aufrufer sollte Arbeitsspeicher für das Array von BSTRs zuweisen. Wenn das Array größer als erforderlich ist, legen Sie den nicht verwendeten Teil auf 0 fest.
Bei der Rückgabe muss der Aufrufer jedes enthaltene BSTR mithilfe von SysFreeString freigeben.
Bei nicht genügend Arbeitsspeicher verweist pcNames auf den Fehlercode.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | oaidl.h |