Tekenreeksbuffers gebruiken

Functies die tekenreeksen retourneren, bevatten een invoerparameter, lpszBufferen een grootteparameter, lpdwBufferLength-. Hoewel lpszBuffer kan worden NULL-, moet lpdwBufferLength- een geldige aanwijzer zijn naar een DWORD- variabele. Als de invoerbuffer die wordt verwezen door lpszBuffer-NULL- of te klein is om de uitvoertekenreeks vast te houden, mislukt de functie en retourneert GetLastErrorERROR_INSUFFICIENT_BUFFER. De variabele waarnaar wordt verwezen door lpdwBufferLength- bevat een getal dat het aantal bytes aangeeft dat de functie nodig heeft om de aangevraagde tekenreeks te retourneren, inclusief de null- afsluiter. De toepassing moet een buffer van deze grootte toewijzen, de variabele instellen waarnaar wordt verwezen door lpdwBufferLength- op deze waarde en de aanvraag opnieuw indienen. Als de buffergrootte voldoende is om de aangevraagde tekenreeks te ontvangen, wordt de tekenreeks gekopieerd naar de uitvoerbuffer met een null- afsluiter en retourneert de functie een geslaagde indicatie. De variabele die wordt verwezen door lpdwBufferLength- bevat nu het aantal tekens dat in de buffer is opgeslagen, met uitzondering van de null- afsluiter.