Limited time promo

This help topic applies only to novaPDF. If you don't have it yet, you must download it first.

Download now Buy licenses
Adrian (Softland)
Apr 08, 2022
novaPDF 11.x
We strive to keep our help as accurate as possible. If you notice any inconsistencies or outdated info please let us know.
The GetNextProfile continues an enumeration of profiles started with GetFirstProfile, retrieving the id of the next profile in the enumeration.
HRESULT GetNextProfile(
    [out] LPWSTR* p_pwsProfileId
);

Parameters:

p_pwsProfileId
    [out] pointer to a pointer to a null terminated Unicode string containing the name of the next existing profile. The caller must release the allocated memory using CoTaskMemFree.

Return values:

S_OK on success or COM error code
NV_NOT_INITIALIZED - Initialize was not called
NV_ENUM_NOT_INIT - enumerate was not started, GetFirstProfile was not called before
NV_NO_MORE_PROFILES - there are no more profiles to enumerate

Remarks:

GetNextProfile is used with GetFirstProfile to retrieve profile names.
Sample usage:
hr = GetFirstProfile(&pName);
while (SUCCEEDED(hr) && hr != NV_NO_MORE_PROFILES) {
    // do something with pName
    //...
    CoTaskMemFree(pName);
    // get next profile if it exists
    hr = GetNextProfile(&pName);
}